【译】从 Express 3.x 迁移到 4.x

Express 3.x 到 4.0 的迁移指南。你可能对这篇文章也有兴趣4.x版中的新功能。

更多的例子和完整的API文档，请参见Express 4.x 的文档。

概述

Express 4 不再依赖 Connect 。这意味着所有捆绑的中间件（除了static）都不再能从express模块中被调用。这些中间件都可以作为下面提及的模块进行调用。这一变化是为了让这些中间件在获取修复，更新和发布的同时不影响 express 的发布周期，反之亦然。

• bodyParser body-parser
• cookieParser cookie-parser
• favicon static-favicon
• session express-session

其他模块在这里 https://github.com/senchalabs/connect#middleware

移除

app.configure()

这种方法不再可用。如果你想配置基于环境的不同路由，使用 if 语句或替代模块。

app.configure('development', function() {
   // configure stuff here
});
// 现在改为
var env = process.env.NODE_ENV || 'development';
if ('development' == env) {
   // configure stuff here
}

app.router

这个中间件已经全面改版，以此避免.use同.get之间的混淆（或者是其他HTTP动作），同时，不再需要手动声明的app.use(app.router)（已被移除）。查看下面关于新的中间件和路由 API 的一节。

如果你的代码看起来像这样：

app.use(cookieParser());
app.use(bodyParser());
/// 其他的中间件，并没有影响
app.use(app.router); // <--- 这行会被移除

// 更多的中间件（在路由之后执行）
app.use(function(req, res, next);
// 处理错误的中间件
app.use(function(err, req, res, next) {});

app.get('/' ...);
app.post(...);

app.router已被移除，中间件和路由按照它们添加的顺序被执行。在你的代码中，你应该将原本在app.use(app.router)之后的向app.use的请求移动到其他路由之后（HTTP动作）。

app.use(cookieParser());
app.use(bodyParser());
/// 其他的中间件，并没有影响

app.get('/' ...);
app.post(...);

// 更多的中间件（在路由后执行）
app.use(function(req, res, next);
// 处理错误的中间件
app.use(function(err, req, res, next) {});

express.createServer()

长期弃用。现在只要使用`express()'创建一个新的应用。

connect 中间件

除了express.static为了便捷性直接封装在 express 中，其他所有 connect 的中间件都被分离到了独立的模块中。由此，每个独立的模块都可以拥有自己的版本控制。

connect 的补丁

Connect 对 node 的原型进行了全局的改动。
这被认为是不正确的，所以在 Connect 3 中已被移除。
其中一些补丁是：

• res.on('header')
• res.charset
• res.headerSent - use node's res.headersSent instead

你不应该在任何 Connect 或 Express 的库中再使用这些。

res.charset

如果你想快速设置默认的字符集（你确实应该这么做），
使用 res.set('content-type') 或者 res.type() 来设置 header 。
当使用res.setHeader()时，默认的字符集将不会添加。

改动

app.use

app.use 现在可以接受 :params.

app.use('/users/:user_id', function(req, res, next) {
  // req.params.user_id 可以正确获取
});

req.accepted()

使用req.accepts()来代替。

• req.accepts()
• req.acceptsEncodings()
• req.acceptsCharsets()
• req.acceptsLanguages()

都在内部使用 accepts。
请参考accepts来提交问题或者查看文档。

请注意，这些属性可能已经从数组改为函数。
要把它们作为“数组”使用，只要不向它们传递任何参数即可。
例如, req.acceptsLanguages() // => ['en', 'es', 'fr'].

res.location()

不再做相对路径的 URL 解析。浏览器自身将处理相对路径的 URL 。

app.route -> app.mountpath

当把一个 express 应用安装到另一个 express 应用中时。

配置改动

• json spaces 在开发模式下不再默认启用。

req.params

现在它是一个对象而不是数组。如果你以前使用req.params[##]的形式，这不会破坏你的应用，它可以在不知道参数名的情况下，使用正则来处理路由。

res.locals

不再是一个函数。现在这是一个普通的JS对象。所以把它当作普通的对象来处理。

res.headerSent

改为headersSent来匹配 node.js 的 ServerResponse 对象。你的应用可能并没有使用到这个，因此它不会是一个问题。

req.is

现在在内部使用 type-is。
请参考type-is来提交问题或者查看文档。

新加入

app.route(path)

返回一个新的Route的实例。当收到和这个路由的path相匹配的请求时，这个路由就会被调用。路由可以有自己的中间件和针对 HTTP 动作的方法来处理请求。

请参阅路由和路由线路文档，以便更好地了解如何在 express 中创建路由。

Router 和 Route 中间件

Router 已经全面改版，现在它是一个功能完善的中间件路由。Router 是在不牺牲参数匹配和中间件的情况下，将你的路由分离到多个文件或者模块的好方法。请参阅 Routes 及路由文档 。